home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_1 / lemon34.zip / LEMON.DOC < prev    next >
Text File  |  1992-12-08  |  15KB  |  372 lines
  1.  
  2.  
  3.                        ============================
  4.                                 LEMONADE!
  5.                        ============================
  6.                          (c)1990-92 T&J Software
  7.  
  8.         One of the T&J Software Collection of multi-BBS door programs.
  9.            Supporting PCBoard, Wildcat!, Gap, QBBS, RBBS, Spitfire,
  10.              UltraBBS, Telegard, TriBBS, Remote Access, WWIV, and
  11.                               Wildcat! IM
  12.  
  13.                        VERSION 3.40     11/30/92
  14.  
  15.                                    By
  16.  
  17.                                Tom Wildoner
  18.                              397 West Broadway
  19.                               Jim Thorpe, PA
  20.                                   18229
  21.                             VOICE (717)325-9480
  22.                    *between 5:30 & 10:00 p.m. Eastern Time
  23.  
  24.                                   From
  25.  
  26.                                The T&J BBS
  27.                               (717)325-9481
  28.                         1200/2400/9600/19200/38400
  29.                                24 Hours/Day
  30.  
  31. LATEST VERSION:
  32. ===============
  33.  
  34. Please call the T&J BBS for the latest version of this program.
  35.  
  36. LEGALITIES:
  37. ===========
  38.  
  39. THIS SOFTWARE AND ACCOMPANYING MATERIALS ARE DISTRIBUTED "AS IS" WITHOUT
  40. WARRANTY, EXPRESS, IMPLIED OR STATUTORY, INCLUDING BUT NOT LIMITED TO ANY
  41. IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  42. IN NO EVENT SHALL ANYONE INVOLVED WITH THE CREATION AND PRODUCTION OF THIS
  43. PRODUCT BE LIABLE FOR INDIRECT, SPECIAL, OR CONSEQUENTIAL DAMAGES, ARISING
  44. OUT OF ANY USE THEREOF OR BREACH OF ANY WARRANTY.
  45.  
  46. DISTRIBUTION:
  47. =============
  48.  
  49. You may make this file available for downloading from your BBS or you may
  50. upload it to any BBS of your choice, provided that you do not make any
  51. changes to the contents of the archive (ZIP file). The archive and its
  52. individual contents may not be used by any service that charges any money
  53. whatsoever, without the written permission of the author.
  54.  
  55. PROGRAM DESCRIPTION:
  56. ====================
  57.  
  58. LEMONADE is a fairly simple game. Your mother has given you $1.00 to get
  59. your lemonade stand started. The object of the game is to sell as many
  60. glasses of lemonade as possible in a set number of days.
  61.  
  62. After the user hits the 'N' key he will be shown today's weather forecast.
  63. He will then be prompted to enter how many glasses he wants to make followed
  64. by how much to charge per glass.
  65.  
  66. The weather and temperature have a direct bearing on how many glasses will
  67. be sold. If it rains, none will be sold.
  68.  
  69.  
  70. NOTE:
  71. =====
  72.  
  73. The LEMON.KEY file that is distributed with this door does NOT expire!
  74. This is simply here so the door has a KEY to read. When you register,
  75. you will receive a new LEMON.KEY file.
  76.  
  77. The user is limited to 4 GAME DAYS until registerd.
  78.  
  79. The user is limited to just ONE play per day until registered.
  80.  
  81.  
  82. FEATURES:
  83. =========
  84.            --- Desqview Aware.
  85.            --- COM1-4 support and non-standard IRQ's.
  86.            --- Colorful ANSI screens.
  87.            --- Chat function.
  88.            --- NO BRUN module needed for play.
  89.            --- Will return to BBS on dropped carrier.
  90.            --- Will TIMEOUT a player after 5 minutes of no activity.
  91.            --- Use of HOT KEYS while in the door.
  92.            --- Support BBS available.
  93.            --- Easily RESET the entire program.
  94.  
  95.  
  96. INSTALLATION:
  97. =============
  98.  
  99. Run Lemonade with the command line UTILITY to bring up an options
  100. menu to easily install and reset the game!
  101.  
  102. Example:   LEMON UTILITY
  103.  
  104. CONFIGURATION:
  105. =============
  106.  
  107. Example configuration file for PCBOARD.SYS
  108. ------------------------------------------
  109.  
  110. C:\PCB\PCBOARD.SYS  <=-  (Full pathname of your PCBOARD.SYS file)
  111. T&J Software        <=-  (Change this to your BBS name)
  112. Tom                 <=-  (The Sysop's first name)
  113. Wildoner            <=-  (The Sysop's last name)
  114.  
  115. Example configuration file for USERS.SYS
  116. ----------------------------------------
  117.  
  118. C:\PCB\USERS.SYS    <=-  (Full pathname of your USERS.SYS file)
  119. T&J Software        <=-  (Change this to your BBS name)
  120. Tom                 <=-  (The Sysop's first name)
  121. Wildoner            <=-  (The Sysop's last name)
  122.  
  123. Example configuration file for DOOR.SYS
  124. ---------------------------------------
  125.  
  126. C:\BBS\DOOR.SYS     <=-  (Full pathname of your DOOR.SYS file)
  127. T&J Software        <=-  (Change this to your BBS name)
  128. Tom                 <=-  (The Sysop's first name)
  129. Wildoner            <=-  (The Sysop's last name)
  130.  
  131. Example configuration file for USERINFO.DAT
  132. -------------------------------------------
  133.  
  134. C:\BBS\USERINFO.DAT <=-  (Full pathname of your USERINFO.DAT file)
  135. T&J Software        <=-  (Change this to your BBS name)
  136. Tom                 <=-  (The Sysop's first name)
  137. Wildoner            <=-  (The Sysop's last name)
  138. NOTE: DOOR.SYS must be in the SAME directory as USERINFO.DAT
  139.  
  140. Example configuration file for CALLINFO.BBS
  141. -------------------------------------------
  142.  
  143. C:\BBS\CALLINFO.BBS <=-  (Full pathname of your CALLINFO.BBS file)
  144. T&J Software        <=-  (Change this to your BBS name)
  145. Tom                 <=-  (The Sysop's first name)
  146. Wildoner            <=-  (The Sysop's last name)
  147.  
  148. Example configuration file for DORINFOx.DEF
  149. -------------------------------------------
  150.  
  151. C:\BBS\DORINFOx.DEF <=-  (Full pathname of your DORINFOx.DEF file
  152.                           where 'x' is the BBS Node number.
  153. T&J Software        <=-  (Change this to your BBS name)
  154. Tom                 <=-  (The Sysop's first name)
  155. Wildoner            <=-  (The Sysop's last name)
  156.  
  157. Example configuration file for SFDOORS.DAT
  158. ------------------------------------------
  159.  
  160. C:\BBS\SFDOORS.DAT  <=-  (Full pathname of your SFDOORS.DAT file)
  161. T&J Software        <=-  (Change this to your BBS name)
  162. Tom                 <=-  (The Sysop's first name)
  163. Wildoner            <=-  (The Sysop's last name)
  164.  
  165. Example configuration file for CHAIN.TXT
  166. ----------------------------------------
  167.  
  168. C:\BBS\CHAIN.TXT    <=-  (Full pathname of your CHAIN.TXT file)
  169. T&J Software        <=-  (Change this to your BBS name)
  170. Tom                 <=-  (The Sysop's first name)
  171. Wildoner            <=-  (The Sysop's last name)
  172.  
  173. Example configuration file for GTUSER.BBS
  174. -----------------------------------------
  175.  
  176. C:\BBS\GTUSER.BBS   <=-  (Full pathname of your GTUSER.BBS file)
  177. T&J Software        <=-  (Change this to your BBS name)
  178. Tom                 <=-  (The Sysop's first name)
  179. Wildoner            <=-  (The Sysop's last name)
  180. 1                   <=-  (COM port number - defaults to 1)
  181. 1                   <=-  (Node number - defaults to 1)
  182.  
  183. Example Batch File
  184. ==================
  185.  
  186. A sample batch file is included and is similer to the following:
  187.    ECHO OFF
  188.    CD\DOORS\LEMON           <=- Switch to the door's Directory.
  189.    LEMON LEMON.CFG          <=- Execute the door program and pass the
  190.                                 configuration filename to the program.
  191.    CD\PCB                   <=- Go back to PCB DIR when user exits door.
  192.    BOARD                    <=- Restart BBS.
  193.  
  194. This Door is multi-node  compatible so you may run more than 1 node from
  195. the same .CFG file provided the path to your system file (DORINFOx.DEF,
  196. CALLINFO.BBS, etc) is exactly the same unless you are using environment
  197. variables, (q.v.)
  198.  
  199. Environment Variables
  200. =====================
  201.  
  202. PCBoard automatically creates the %PCBDRIVE% & %PCBDIR% environment
  203. variables. Non-PCBoard systems may also use these variables by including
  204. the following in either your BBS batch or AUTOEXEC.BAT
  205.   SET PCBDRIVE=C:               <- Drive letter of your BBS files
  206.   SET PCBDIR=\BBSDIR            <- Path to your BBS files
  207. Then in your Door .CFG file instead of putting C:\BBSDIR\DOOR.SYS, you
  208. would put %PCBDRIVE%%PCBDIR%\DOOR.SYS. This allows you to use just one
  209. .CFG file for multi-node operation!
  210.  
  211. To specify a non-standard IRQ, put the IRQ number after the .CFG on the
  212. command line.  For example:
  213.  
  214.      LEMON LEMON.CFG /5
  215. or using the PCBDRIVE procedure:   SET IRQ=5   and use
  216.      LEMON LEMON.CFG /%IRQ%
  217.  
  218. This tells the program to use IRQ 5 instead of the standard IRQ.
  219.  
  220.   Had reports of conflicts when using non-standard IRQ's on Novell/Netware
  221.  systems. Seems Novell also uses the / character so something went screwy
  222.  somewhere. So I added the * (asterisk) which may be used instead of the /
  223.  in case of a conflict. In other words, /%IRQ% and *%IRQ% will both work
  224.  and are interchangeable.
  225.  
  226. When specifying the location of the system file on line 1 of the doors .CFG
  227. file, you may use the environment variables %pcbdrive%, %pcbdir%, %pcbnode%,
  228. and %wcnodeid%. Some examples:
  229.  PCBoard: 
  230.    USERS.SYS in C:\PCB           - %pcbdrive%%pcbdir%\USERS.SYS
  231.    USERS.SYS in C:\PCB\NODE1     - %pcbdrive%%pcbdir%\NODE%pcbnode%\USERS.SYS
  232.  
  233.  Wildcat!:
  234.    USERINFO.DAT in C:\WC\NODE1   - C:\WC\NODE%wcnodeid%
  235.  
  236. Non-PCBoard systems may use the PCB environment variables by setting them
  237. in either AUTOEXEC.BAT or in the batch that runs the door. For example:
  238.  SET PCBDRIVE=C:
  239.  SET PCBDIR=\BBSDIR
  240.  SET PCBNODE=1
  241.  
  242. Fossil Driver Support
  243. ---------------------
  244. DoorFrame supports the use of Fossil drivers.  To tell your Door to use the
  245. Fossil driver instead of the standard COM ports, just put /FD on the command
  246. line when running the door. For example:
  247.      MYDOOR MYDOOR.CFG /FD
  248. indicates that a Fossil driver is present and should be used. If no Fossil
  249. driver is detected, DoorFrame will print a message to that effect and exit
  250. the door gracefully.
  251.  
  252. Sysop Keys
  253. ==========
  254.  
  255. F3    -  Toggles the printer On/Off. Value is passed to PCBoard and/or
  256.          written to DOOR.SYS and USERS.SYS
  257. F4    -  Toggles the Page Bell on/off. Value is passed to PCBoard
  258.          and/or written to DOOR.SYS and USERS.SYS
  259. F5    -  DOS Shell. Allows SysOp to exit to DOS from inside a DOOR.
  260. F7    -  Toggles the Caller Alarm On/Off. Value is passed to PCBoard
  261.          and/or written to DOOR.SYS and USERS.SYS
  262. F8    -  Returns the caller involuntarily to the BBS.
  263. F9    -  Toggles the local display On/Off. Value is passed to PCBoard
  264.          and/or written to DOOR.SYS and USERS.SYS
  265. F10   -  Activates SysOp CHAT mode within the DOOR.
  266. ESC   -  Deactivates CHAT mode.  DOOR is resumed.
  267. UP    -  Give the caller extra time while in the DOOR.  
  268. DN    -  Subtract time from the caller while in the DOOR. 
  269. HOME  -  HELP key for Status Line options.
  270. ALT-N -  SysOp next on toggle. Value passed to PCBoard. (PCBoard only)
  271. ALT-X -  PCBoard will exit after current caller logs off. Value is
  272.          passed to PCBoard. Not available on non-PCBoard systems.
  273.  
  274.  
  275.  
  276. Your SYSOP.CFG file should contain ALL the items listed below. You can use
  277. your text editor to edit the provided file.
  278.  
  279. c:\wc30\bull\bull1.scr
  280. c:\wc30\bull\bull1.bbs
  281. 25
  282. 3
  283.  
  284. LINE   1: PATH to your color bulletin.
  285. LINE   2: PATH to your ASCII bulletin.
  286. LINE   3: How many GAME DAYS per play.
  287. LINE   4: How many plays per day.
  288.  
  289. The file MUST have all 4 lines!
  290.  
  291. LOCAL PLAY:
  292. ==========
  293.  
  294. Simply run Lemonade using the command line LOCAL. This will give you the
  295. option to play door locally using several different people or logon
  296. names.
  297.  
  298. Example: LEMON LOCAL
  299.  
  300.  
  301. MAINTENANCE!:
  302. ============
  303.  
  304. None required. The door will reset the scores every month.
  305.  
  306. FUTURE VERSIONS:
  307. ================
  308.  
  309. --->> Let me know what you would like to see!
  310.  
  311.  
  312. VERSION HISTORY:
  313. ===============
  314.  
  315. Version 0.30 BETA..... BETA release. 8/1/90
  316. Version 1.00 ......... First release. 8/9/90
  317. Version 1.10 ......... Fixed remote screen bug associated with using
  318.                        this program under a LIVECAT environment.
  319.                        Fixed an exponential bug associated with very
  320.                        high scores.
  321. Version 1.20 ......... Fixed a small problem in the amount a person
  322.                        can charge per glass of lemonade. It is now very
  323.                        unlikely that anybody can sell a glass of
  324.                        lemonade if they charge more than 50 cents per
  325.                        glass.
  326. Version 1.30 ......... Cleaned up the code to stop the generation of
  327.                        ERROR #6 (number being to large). Program now
  328.                        will only allow users to make 1000 glasses/day
  329.                        and will not allow them to charge more than 100
  330.                        cents per glass.
  331.                        Added bulletin generation outside of the main
  332.                        EXE file. This will give me some room in the code
  333.                        for some future additions.
  334. Version 1.40 ......... Maintenance release to show new BBS name and
  335.                        number. 8/17/91
  336. Version 1.45 ......... Minor BUG fix in the number of glasses.
  337.                        09/01/91
  338. Version 2.00 ......... Now supports WC 2.x and 3.x! Added an internal
  339.                        bulletin generator. Make door stand alone, no
  340.                        need for BRUN45 module. Now programmed using the
  341.                        Microsoft BASIC PDS v7.1. Added the SETUP command
  342.                        line (no external SETUP program needed) --
  343.                        Added maintenance routine and more SysOp
  344.                        configuration options.
  345.                        09/16/91
  346. Version 2.10 ......... Fix for unlocked com ports (Wildcat 3.x only).
  347. Version 3.00 ......... Door recompiled using new door routines. An
  348.                        overall facelift was done. Nicer bulletins.
  349.                        04-25-1992
  350. Version 3.10 ......... Door recompiled using newer door routines.
  351.                        05-17-1992
  352. Version 3.20 ......... Sorry, used the wrong bulletin routines! You must
  353.                        now beat your old score before your score is added
  354.                        to the bulletin. 05-21-92
  355. Version 3.30 ......... Updated to newest door routines. Added the RESET
  356.                        program to the main code via a command string.
  357.                        05-24-92
  358. Version 3.40 ......... Updated to the newest routines. Now supports
  359.                        fossil drivers and the short DOOR.SYS which is
  360.                        created by some BBS packages. The bulletins are
  361.                        now a lot sharper!  11-30-1992
  362.  
  363.  
  364. REGISTERING:
  365. ============
  366.  
  367. That's all there is to it! If you have any problems or questions
  368. please feel free to call the T&J BBS at (717)325-9481 and join the
  369. T&J Software Conference.
  370.  
  371. See the enclosed registration form for ordering!  (REGISTER.TXT)
  372.